home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / utility / wfind.zip / WFIND2.DOC < prev    next >
Text File  |  1996-06-19  |  7KB  |  162 lines
  1. June 1996    
  2.     This program consists of three files: 
  3.         
  4.         WFIND2.EXE   the main program
  5.         WFIND2.DOC   this file, also used as the help file
  6.         WF2.BAT      runs and coordinates the main program 
  7.     
  8.     NOTICE: 
  9.     WFIND2.EXE creates and overwrites the following files:
  10.  
  11.         the File List         filelist.lst
  12.         the Search List       srchlist.lst
  13.         the Batch File        xwnewbat.bat
  14. .   
  15.     on your temporary directory.
  16.     
  17.     If you need files with these names for some other purpose, then don't 
  18.     use this program.
  19.     
  20.     To begin:
  21.     Enter WF2 followed by filenames (up to 10 items, wild cards * and ? are ok)
  22.     on the command line, separated by spaces. To search all subdirectories 
  23.     of an item, follow the item by /S (no space).
  24.     
  25.     Enter WF2 *.* to create a File List of all files on the current directory 
  26.     for the current drive. Enter WF2 C:\*.TXT/S to create a File List of all 
  27.     files on drive C with extension TXT.
  28.     
  29.     The File List and the Search List themselves are never searched.
  30.     
  31.     The WF2.BAT Menu:
  32.  
  33.     1. Search: You are prompted to enter a search string in quotes. It 
  34.     may contain the wild cards * or ?, as explained below:
  35.         
  36.         a) * means any sequence of characters (including the empty sequence), 
  37.         up to the next part. In particular, if the "search string" is 
  38.         "part1*part2", the program searches first for "part1". If "part1" 
  39.         is found then the search continues for "part2". If "part2" is found 
  40.         and the entire string is of 64 or less characters we have an 
  41.         occurrence of "part1*part2". The display will show the entire string 
  42.         in reverse video. Note that ** is the same as * and "*part1*" is the 
  43.         same as "part1".
  44.         
  45.         b) ? means any character, even a control character.
  46.     
  47.     The starting quote is included automatically. After the ending quote 
  48.     you may want to include some switches, such as:
  49.         
  50.         /P    pause the display of file names in a search
  51.         /I    do a case insensitive search
  52.         /Ln   n or more occurrences of the search string is required for a find
  53.               /L1 is the default
  54.  
  55.     The search displays each file in the File List, preceded by the number 
  56.     of occurrences of the search string, up to the number required for a find.
  57.  
  58.     Example: "the" /I /L5
  59.     The search is case insensitive (T or t are treated as the same).
  60.     5 or more occurrences of the search string are required for a find, i.e.
  61.     to send the file to the Search List.
  62.  
  63.     Example: ""
  64.     This is the empty search. "" is always found in any file in an unlimited 
  65.     number of occurrences.
  66.  
  67.     Example: "Version" /I 
  68.     Use this on EXE or COM files to find a version number.
  69.  
  70.     Example: "the*the"
  71.     This is exactly the same as entering: "the" /L2
  72.  
  73.     The choices 2 - 6 provide the Boolean search options.
  74.  
  75.     2. NOT Search: The files that would not go to the Search List in an 
  76.     ordinary search are exactly the ones that go to the Search List in a
  77.     NOT Search.
  78.  
  79.     3. AND Search: The Search List is copied to the File List. Accordingly, 
  80.     only files already in the Search List will be searched. The original 
  81.     File List can be restored by selecting <R> on the menu.
  82.  
  83.     4. AND NOT Search: Combine the AND and the NOT Search remarks above.
  84.  
  85.     5. OR Search: The files sent to the Search List are added to those
  86.     already in the Search List. This may result in duplicate files in the
  87.     Search List.
  88.  
  89.     6. OR NOT Search: Combine the OR and the NOT Search remarks above.
  90.  
  91.     X Extract Display / Act: Extracts from the files in the Search List are 
  92.     displayed (except for files added in a NOT Search). An extract consists 
  93.     of 76 characters from the file (as the characters are stored on the disk,
  94.     in binary format). In an empty ("") search the first 76 characters of the 
  95.     file are shown. Otherwise, the extract is centered on the search string, 
  96.     which is shown in reverse video. 
  97.  
  98.     The extract is modified as follows:
  99.         
  100.         1. characters with ASCII values under 32 (control characters)
  101.         are displayed as degree symbols, character 248, '°'.
  102.         
  103.         2. characters before the beginning of the file and after the end of
  104.         the file are displayed as half-tone rectangles, character 177, '▒'.
  105.     
  106.     In a text file a pair of degree sympols usually indicates the end of 
  107.     a line. Non text files may look like a mess of strange symbols with
  108.     occasional familiar words.
  109.  
  110.     Each page of extracts contains up to 22 lines, one of which is in reverse
  111.     video. The file corresponding to this line is shown on the bottom of the
  112.     screen. The reverse video line can be moved up and down by the up and down
  113.     arrows. Press <Page Down> to get the next page. After the last page, page
  114.     1 returns. 
  115.     
  116.     Press <Space Bar> to select the reverse video line. Then you are prompted 
  117.     for a command to apply to the corresponding file. For example, for a text 
  118.     file, you may want to enter: EDIT *
  119.     
  120.     The first occurrence of * is replaced by the file name. If you choose to
  121.     act on the command it is sent to the Batch File, xwnewbat.bat. WF2.BAT 
  122.     is arranged to call xwnewbat.bat to carry out your command.
  123.  
  124.     Switches:
  125.  
  126.     For a complete description of the switches available for WFIND2.EXE,
  127.     including the switches to change the display colors and to change the
  128.     search string wild cards, you will need to register below.
  129.  
  130.                         No Warranty:
  131.                         ───────────  
  132.  
  133.     There is no warranty. Use this product at your own risk.
  134.                        
  135.                        Use of the program:
  136.                        ──────────────────
  137.  
  138.     This is a shareware program. If you find it useful please register the
  139.     program by sending $5 to the following address:
  140.  
  141.                 Joel Westman
  142.                 13320 SE Reedway CT
  143.                 Portland, OR 97236
  144.  
  145.     I can be reached at Compuserve User ID number 72067,145
  146.  
  147.     Please enclose the following:
  148.  
  149.     The name of the program: WFIND2 version 2.0
  150.  
  151.     Your Name: _________________________
  152.  
  153.     Address : __________________________
  154.  
  155.     City, State, Zip: __________________
  156.  
  157.     Remarks: ___________________________
  158.  
  159.     You will receive a complete list of switches to control XWFIND2.EXE
  160.     and a more complete description of the operation of the program.
  161.  
  162.